home *** CD-ROM | disk | FTP | other *** search
/ InterCD 2000 September / september_2000.iso / intercd / root / ^Linux / WindowMaker / README.definable-cursor < prev    next >
Encoding:
Text File  |  2000-03-09  |  2.8 KB  |  87 lines
  1. # README.definable-cursor: How to use definable-cursor patch for Window Maker
  2. # created 1999-Apr-24 14:53 jmk
  3. # autodate: 1999-Apr-24 16:29
  4.  
  5. __________________________________________________
  6. |O|  Definable Mouse Cursors for Window Maker  |X|
  7. ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  8.  
  9. The definable-cursor patch for Window Maker
  10. <http://www.windowmaker.org/> allows user-definable mouse cursors; the
  11. cursors can either be the built-in ones from the X11 cursor font, or
  12. they can be bitmap (XBM) files.  User-definable cursors can be useful
  13. for theme-builders, lefthanders, and the visually impaired.
  14.  
  15. This README describes how to apply the patch to Window Maker and how to
  16. use the features it enables.
  17.  
  18. ____________________________
  19. |O|  Applying the Patch  |X|
  20. ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  21.  
  22. The definable-cursor patch is available from
  23. <http://www.pobox.com/~jmknoble/WindowMaker/patches/>.
  24.  
  25. To apply the patch, do the following (where `XX' is the version of
  26. Window Maker you're patching):
  27.  
  28.     (0) gzip -dc WindowMaker-XX.tar.gz | tar -xvf -
  29.     
  30.     (1) cd ./WindowMaker-XX
  31.     
  32.     (2) patch </wherever/you/put/WindowMaker-XX-definable-cursor.patch
  33.     
  34.     (3) Build Window Maker according to the instructions in the
  35.         accompanying `INSTALL' file.
  36.  
  37. ___________________________________
  38. |O|  Defining Your Own Cursors  |X|
  39. ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  40.  
  41. A cursor specification is one of:
  42.  
  43.     (none)
  44.     (builtin, <cursor-name>)
  45.     (bitmap, <bitmap-filename>, <mask-filename>)
  46.  
  47. where <cursor-name> uses the same syntax as for `xsetroot -cursor_name',
  48. and <bitmap-filename> and <mask-filename> are the same as for
  49. `xsetroot -cursor'; <bitmap-filename> and <mask-filename> are searched
  50. for along WM's PixmapPath.  If you use `(none)', the cursor will be
  51. inherited from the parent window (which often ends up being the root
  52. window).
  53.  
  54. You can set the following cursor types (they're shown here with their
  55. defaults):
  56.  
  57.     NormalCursor = (builtin, left_ptr);
  58.     MoveCursor   = (builtin, fleur);
  59.     ResizeCursor = (builtin, sizing);
  60.     WaitCursor   = (builtin, watch);
  61.  
  62. ______________________
  63. |O|  Random Notes  |X|
  64. ^^^^^^^^^^^^^^^^^^^^^^
  65.  
  66. Most X11 cursors are 16x16 bitmaps.  Many X servers can actually handle
  67. larger cursors, though.  To check, use:
  68.  
  69.     xdpyinfo
  70.  
  71. and in the resulting output look for a line such as:
  72.  
  73.     largest cursor:    64x64
  74.  
  75. The example above indicates that my X server can handle cursors up to
  76. 64 pixels wide by 64 pixels high.
  77.  
  78. You can create your own bitmap cursors using the `bitmap' program that
  79. accompanies most X11 distributions.  For example bitmap cursors, see
  80. <http://www.pobox.com/~jmknoble/WindowMaker/cursors/>.
  81.  
  82. For an example
  83.  
  84. --jim
  85.  
  86. %%%%%%%%%%%%%%% jim knoble %%%%%%%% jmknoble@pobox.com %%%%%%%%%%%%%%%%%
  87.